13. Multiple operations
Each of the previously described operations acts upon a single entity or resource only. Frequently we have the need to update an interconnected set of entities so that we maintain the consistency of the structure. This requires an atomic operation which can successfully update all the entities or roll back the operation on failure.
The MultiOpType
operation provides such a feature. It is essentially a wrapper around any of the other operations which guarantees the success of the entire set or a roll back. Using the id attribute for requests, each individual response can be located in the result. The MultiOpType
request takes the following elements
MultiOpType
elementsField | Type | # | ? | Description |
---|---|---|---|---|
| Sequence of | 1 | Y | Contains one or more operations |
The response type is also simple containing a single element containing all the responses.
MultiOpResponseType
elementsField | Type | # | ? | Description |
---|---|---|---|---|
| Sequence of | 1 | Y | Contains zero or more responses |